How it Works

The Job Log Explorer relies on regular expressions to parse job logs language independently. The regular expressions are hard coded in the source code, but can be overridden with file jobLogParser.properties. Refer to the preferences for details.

The parser uses four regular expressions to retrieve the job log information from different parts of the job log. All regular expressions used by the parser are shown in file example_jobLogParser_vX.X.properties. The file is created in the following directory when the Job Log Explorer is started for the first time:

[workspace]/.metadata/.plugins/biz.isphere.joblogexplorer/joblogparser/

Page Header

Usually a job log page header looks like this:

  5770SS1 V7R2M0 140418                        Display Job Log                       PUB400    03.11.16  14:58:40 CET     Page    1

The following attributes are used to identify the page header:

AttributeExample Value
Licensed Program5770SS1
ReleaseV7R2M0
System NamePUB400
Date03.11.16
Time14:58:40
Time ZoneCET
Page Number LabelPage
Page Number1

Header Attributes

The page header attributes specify the job name and the job description like this:

  Job name . . . . . . . . . . :   TRADDATZA1      User  . . . . . . :   RADDATZ      Number . . . . . . . . . . . :   245231
  Job description  . . . . . . :   QDFTJOBD        Library . . . . . :   QGPL

The following attributes are used to identify a header attribute:

AttributeExample Value
Attribute NameJob name
Attribute ValueTRADDATZA1

First Line of a Message

The basic message attributes are retrieved from the first line of a job log message:

  CPCA980    Completion              00   19.12.16  11:52:58,698357  QP0ZADDE     QSYS        *STMT    START#RZ    RADDATZ     *STMT

The following attributes are retrieved from the first line of a message:

AttributeExample Value
IDCPCA980
TypeCompletion
Severity00
Date Sent19.12.16
Time Sent11:52:58,698357
From ProgramQP0ZADDE
From LibraryQSYS
From Statement*STMT
To ProgramSTART#RZ
To LibraryRADDATZ
To Statement*STMT

Message Continuation Lines

The message continuation lines contain information about the sending and receiving programs and the message text and help text:

  From module . . . . . . . . :   QP0ZADDE
  From procedure  . . . . . . :   main
  Statement . . . . . . . . . :   226
  To module . . . . . . . . . :   START#RZ
  To procedure  . . . . . . . :   START#RZ
  Statement . . . . . . . . . :   3200
  Message . . . . :   Environment variable added.
  Cause . . . . . :   Environment variable 'strgh.log4rpg' has been added.

The following attributes are retrieved from the message continuation lines:

AttributeExample Value
From ModuleQP0ZADDE
From Proceduremain
From Statement226
To ModuleSTART#RZ
To ProcedureSTART#RZ
To Statement3200
Message TextEnvironment variable added.
Message HelpEnvironment variable 'strgh.log4rpg' has been added.

The parser relies on the sequence of the continuation lines and it assumes that there are either: